home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr35 / getdiz11.zip / GET-DIZ.DOC < prev    next >
Text File  |  1993-04-21  |  11KB  |  208 lines
  1. ┌─────────────────────────────────────────────────────────────────────────────┐
  2. │ ▒▒▒▒  GET-DIZ v1.1  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  3. └─────────────────────────────────────────────────────────────────────────────┘
  4.  
  5.  
  6.                  Puts FILE_ID.DIZ descriptions in RA 2.00's FDB
  7.  
  8.                              Written by Mike Ehlert
  9.                     (c) Copyright 1992 All Rights Reserved
  10.  
  11.                                    Mike Ehlert 
  12.                    PACIFIC COAST MICRO
  13.                                 1879 Campbell Ave.
  14.                            Thousand Oaks, CA. 91360 USA
  15.  
  16.                 (805) 494-9386 / (805) 497-3456  / (805) 496-7320
  17.  
  18.                                FidoNet: 1:102/1001
  19.  
  20.  
  21. ┌─────────────────────────────────────────────────────────────────────────────┐
  22. │ ▒▒▒▒  What can this do ?  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  23. └─────────────────────────────────────────────────────────────────────────────┘
  24.  
  25.        GET-DIZ is an add-on utility for the RemoteAccess 2.00 File Manager.
  26.        It allows you to quickly scan some or all files in the current area
  27.        for FILE_ID.DIZ or DESC.SDN file descriptions, and each time one is
  28.        found it puts that description into RA's FDB (file data base) even
  29.        if a differnt description already existed there.
  30.        
  31.        DIZ stands for "Description In Zip", and FILE_ID.DIZ descriptions
  32.        were originally use by PCBoard BBS Software. DESC.SDN is a similar
  33.        description file, used by the Software Distribution Network.
  34.        
  35. ┌─────────────────────────────────────────────────────────────────────────────┐
  36. │ ▒▒▒▒  Whats new in version 1.1? ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  37. └─────────────────────────────────────────────────────────────────────────────┘
  38.  
  39.       This version has support for PolyXarc, to support *any* archive type.
  40.       (Thanks to David Gibbs of the Midrange System for the suggestion.)
  41.       The docs now explain how to get around a bug if using DOS 3.3 or 4DOS.
  42.       
  43.       ** Notice ** the file names have been renamed in this version!
  44.       Be sure to update raconfig accordingly!
  45.       
  46. ┌─────────────────────────────────────────────────────────────────────────────┐
  47. │ ▒▒▒▒  Required Programs  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  48. └─────────────────────────────────────────────────────────────────────────────┘
  49.  
  50.        GET-DIZ is not a stand alone program, and requires the following
  51.        other programs to properly run:
  52.  
  53.        RAMGR.EXE    (RA Manager which comes with RA 2.00)
  54.        KIS.EXE      (Keyboard Input Simulator by R. van Hoven)
  55.        PKUNZIP.EXE  (Pkunzip by PKware)
  56.        ARJ.EXE      (Arj by Robert K Jung)
  57.        POLYXARC.EXE (*optional* the GET-DIZX.com version can use this
  58.                      which is a slower method but handles all archive
  59.                      types. PolyXarc by Jeffrey Nonken)
  60.        
  61.        RAMGR is required since this is an add-on for it which is designed
  62.        to be only called from RAMGR.EXE directly.
  63.  
  64.        The reason that KIS is needed is to stuff keys into the keyboard
  65.        buffer before returning to RAMGR, to force RAMGR to perform the FDB
  66.        updates and to force GET-DIZ to be called again for the next file(s).
  67.        You can freq. or download the latest KIS from any DISP support
  68.        site, or from me. The current version is KIS_V101.ZIP (15k).
  69.  
  70.        PolyXarc is only needed if you install the GET-DIZX.COM version of
  71.        GET-DIZ. PolyXarc is a universal archiver which handles ZIP, ARJ,
  72.        LZH PAK, DWC, ZOO, etc. It still requires that you have the actual
  73.        archive programs as well.
  74.        You can freq. or download the latest PolyXarc from me. I currently 
  75.        have version 21a for DOS: PXDOS21A.ZIP (37k).
  76.  
  77. ┌─────────────────────────────────────────────────────────────────────────────┐
  78. │ ▒▒▒▒  Why 3 versions? ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  79. └─────────────────────────────────────────────────────────────────────────────┘
  80.  
  81.        There are three differnt versions of GET-DIZ include in this archive.
  82.        You only need to use one of them. Which one you use depends on whether
  83.        your BBS converts all files to ZIP, ARJ or if you keep several types.
  84.        
  85.        GET-DIZZ.COM - Zip version.  Assumes all files are ZIPs.     
  86.        GET-DIZA.COM - Arj version.  Assumes all files are ARJs.
  87.        GET-DIZX.COM - PolyXarc ver. Allows *ANY* archive type. 
  88.  
  89.        The disadvantage to using the PolyXarc version is that it is slower
  90.        then the direct versions.
  91.        
  92.        I could have just written one version, which was configurable,
  93.        but it was easyer for me this way (it only took afew minutes to
  94.        write), and since the files are only about 1k each, who cares?
  95.        
  96. ┌─────────────────────────────────────────────────────────────────────────────┐
  97. │ ▒▒▒▒  Installing  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  98. └─────────────────────────────────────────────────────────────────────────────┘
  99.  
  100.        To use GET-DIZ, you must have your archivers and KIS.EXE *somewhere*
  101.        in your path. GET-DIZ*.COM itself does not have to be in the path,
  102.        just somewhere on your hard disk (or a RAM Disk).
  103.        You must also have the RA Environment varable set (eg SET RA=C:\RA).
  104.        
  105.        Run RACONFIG > OPTIONS > FILES > RAMGR-FNKEYS
  106.        
  107.        Change number 2 command line to something like this:
  108.        (shez is just shown as an example, which I use as my file-viewer)
  109.      
  110.        1 c:\shez\shez.exe @ *M
  111.        2 c:\ra\get-dizX.com @
  112.        3 
  113.        4
  114.        5
  115.        
  116.       Notice that GET-DIZ *MUST* be installed in slot #2 (Alt-F2 key).
  117.       >>> ANY POSITION OTHER THEN 2 WILL NOT WORK. <<<
  118.       ************************************************ 
  119.       The reason for this is because it is a self-recursive routine which
  120.       forces RAMGR to call it again for the next file(s) below the cursor.
  121.  
  122. ┌─────────────────────────────────────────────────────────────────────────────┐
  123. │ ▒▒▒▒  Usage  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  124. └─────────────────────────────────────────────────────────────────────────────┘
  125.  
  126.        Once it's installed, run RAMGR -f and select a file area to use.
  127.        Move the cursor to the first file which you wish to process. Press
  128.        Alt-F2 to begin, and RAMGR will call GET-DIZ once for each file
  129.        from there on down.
  130.        So to process an entire area, simply start the cursor at the first
  131.        file (at the top) when you press Alt-F2. If you wish to abort the
  132.        process before it has finished, simply press Ctrl-Break twice.
  133.  
  134.        While its running, PKZIP or ARJ may display File-Not-Found several
  135.        times, which just means that the tested archive did not contain any
  136.        descriptions. This is normal.
  137.  
  138. ┌─────────────────────────────────────────────────────────────────────────────┐
  139. │ ▒▒▒▒  Problems with DOS 3.3 and 4DOS ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  140. └─────────────────────────────────────────────────────────────────────────────┘
  141.  
  142.        There is a known problem with this using DOS 3.3 or 4DOS.
  143.        Here is a cluged which will allow it to work:
  144.  
  145.        
  146.        Go to your root directory.
  147.        Copy config.ra to your root directory.
  148.        Run Raconfig > System > Paths
  149.        Define your root directory as the system directory.
  150.          (for example 'System   C:\'
  151.        Exit Raconfig and save changes (will save config.ra in root).
  152.        Write a small batch file like this:
  153.            C:
  154.        cd\
  155.        set RA=
  156.        copy c:\ra\files.ra
  157.        ramgr -f
  158.        set RA=C:\RA
  159.        
  160.        You could name this filemgr.bat or something, and this cluged batch
  161.        will avoid the problem GET-DIZ has with DOS 3.3 or 4DOS.
  162.        This is *not* required for DOS 4.01, DOS 5.0, or DOS 6.0.
  163.        
  164. ┌─────────────────────────────────────────────────────────────────────────────┐
  165. │ ▒▒▒▒  DesqView Limitations  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  166. └─────────────────────────────────────────────────────────────────────────────┘
  167.  
  168.        GET-DIZ runs perfectly under Desqview, but KIS 1.01 has a limitation:
  169.        You can not switch windows while GET-DIZ is running, or elce KIS will
  170.        stuff the keyboard buffer into the new current window.
  171.        
  172.        If you don't like this limitation, there are three things you can do:
  173.        1. Write to the KIS author and ask him to update KIS.
  174.        2. Or find a Keyfaker program that is fully DV compatible and ask me
  175.           to support it instead. :-)
  176.        3. Or delete this package and forget you ever saw it.
  177.  
  178. ┌─────────────────────────────────────────────────────────────────────────────┐
  179. │ ▒▒▒▒  Disclaimer  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  180. └─────────────────────────────────────────────────────────────────────────────┘
  181.  
  182.        GET-DIZ is supplied as *FreeWare*. It only took me about 20 minutes
  183.        to write it, so there is no sence in me charging you money.
  184.        If you really feel this has made your life alot easyer, you could
  185.        send me a small amount (perhaps enough for a 6-pack of beer), but
  186.        you don't have to.
  187.  
  188.        GET-DIZ was tested, and worked flawlessly on my system (3 lines)
  189.        but still, they come with NO Warranty. Use at your own risk!
  190.  
  191.        In no event shall Mike Ehlert or PACIFIC COAST MICRO be liable for
  192.        any damages caused by GET-DIZ. The software is supplied as-is.
  193.        If it crashes your system, then oh well...
  194.  
  195. ┌─────────────────────────────────────────────────────────────────────────────┐
  196. │ ▒▒▒▒  Credits  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  197. └─────────────────────────────────────────────────────────────────────────────┘
  198.  
  199.       Thanks to Andrew Milner, for writing such a fantastic BBS package.
  200.       Thanks to Bruce Bodger, for asking me to become a RA beta tester.
  201.       Thanks to Ron Huskes, for letting me steal his DOC screens.
  202.       Thanks to Rob van Hoeven, for writing Keyboard Input Simulator.
  203.       Thanks to my wife Cindy, for putting up with my BBS Habit.
  204.  
  205. ┌─────────────────────────────────────────────────────────────────────────────┐
  206. │ ▒▒▒▒  GET-DIZ v1.1  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  207. └─────────────────────────────────────────────────────────────────────────────┘
  208.